MessageUI 命名空间提供了一组 API,用于检测设备的短信发送能力,并展示系统级的短信撰写界面。你可以通过脚本向一个或多个联系人发送短信或彩信,还可以添加主题和附件(如果设备支持)。
MessageUI.isAvailable: boolean如果设备支持发送纯文本短信,返回 true。
MessageUI.canSendSubject: boolean如果设备支持添加“主题”字段,返回 true。
MessageUI.canSendAttachments: boolean如果设备支持在短信中添加“附件”,返回 true。
MessageUI.present(options): Promise<"cancelled" | "sent" | "failed">展示系统的短信撰写界面,并在用户操作完成后返回结果。
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
recipients |
string[] |
是 | 收件人电话号码数组 |
body |
string |
是 | 短信正文内容 |
subject |
string |
否 | 可选的主题内容,仅在 canSendSubject 为 true 时有效 |
attachments |
Attachment[] |
否 | 可选的附件列表,仅在 canSendAttachments 为 true 时有效 |
| 字段名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
data |
Data |
是 | 要附加的二进制数据 |
type |
UTType |
是 | 附件的统一类型标识符,例如 "public.image"、"public.text" 等 |
fileName |
string |
是 | 附件在消息中显示的文件名 |
返回一个 Promise,其结果为以下字符串之一:
"sent":用户已成功发送短信;"cancelled":用户取消了发送;"failed":系统发送失败(如网络或权限问题)。